.. _ceGnUnSearchDevice:

ceGnUnSearchDevice
==================
------------------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 ceGnUnSearchDevice[none] VT_EMPTY



DESCRIPTION
-----------


- 원격 노드 탐색 결과를 초기화 하며, 이 함수가 수행된 이후 ceGnSearchDevice 함수를 통해 원격 노드 탐색을 수행할 수 있습니다.
 
- ceGnIsSearched 함수를 통해 원격 노드가 탐색된 상태인지 확인할 수 있습니다. 원격 노드 탐색 전이면 ceGnSearchDevice 함수를, 원격 노드 탐색 후라면 ceGnReSearchDevice 함수를 사용하시면 됩니다.









RETURN VALUE
------------

+----------------+-------------------------------------------------------+
| Value          | Meaning                                               |
+================+=======================================================+
| 음수           | 수행 실패. 자세한 나용은 '에러 처리' 편을 참고합니다. |
+----------------+-------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공                                             |
+----------------+-------------------------------------------------------+






.. note::
  이 함수는 원격 노드의 탐색 결과를 초기화 하는 함수입니다. 원격 노드 정보 초기화는 다른 cEIP 응용 프로그램에 영향을 주므로 ceGnReSearchDevice 함수를 통해 탐색된 정보를 얻어오시기 바랍니다.




.. seealso::
  :ref:`ceGnSearchDevice`

  :ref:`ceGnReSearchDevice`

  :ref:`ceGnIsSearchedDevice`



Example
-------
.. code-block:: cpp
 :linenos:

 C/C++
 #include “ceSDK.h”
 #include “ceSDKDef.h”
 
 #define REALNODE 10
 #define TIMEOUT 1000
 long nIsSearchedDevice; // 탐색된 원격 노드 정보
 long nNodeCount; // 원격 노드 탐색 여부 정보
 long nRetVal;
 // 원격 노드 탐색 여부를 확인 합니다.
 ceGnIsSearchedDevice ( &nIsSearchedDevice );
 // 원격 노드 탐색 여부를 확인하여 원격 노드의 정보를 탐색합니다.
 if ( nIsSearchedDevice == CE_TRUE ) // 원격 노드 탐색이 수행 되었습니다.
 {
 ceGnUnSearchDevice (); // 원격 노드 탐색 결과를 초기화 합니다.
 /* 이 함수는 원격 노드의 탐색 결과를 초기화 하는 함수입니다. 이 함수 호출 시 다른 cEIP 
 응용 프로그램에 영향을 주므로, 원격 노드를 재 탐색할 필요가 있을 경우 명시적으로 본 함수를 
 호출하지 않고, ceGnReSearchDevice 함수를 통해 재 탐색 하여 주시기 바랍니다. */
 if (ceGnSearchDevice ( REALNODE, TIMEOUT, CE_FALE, &nNodeCount ) != ceERR_NONE )
 {
 // 적절한 에러 처리를 수행하여 주시기 바랍니다.
 }
 }